Port BUSACCESS - FLX

IXXAT-HW access to FlexRay

Stimulation

此端口支持 Stimulation control 中描述的所有功能。

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel number

‘1’

string

当存在多个同类型控制器时,用于选择通道号。

Bus-DB

string

自动 E2E 计算的占位符值

int

只要为 E2E 信号(例如 CRC)指定了该值,ecu.test 在发送时就会自动将其替换为计算出的正确值。该选项的用途是允许发送任意固定值(与本处选择的值不同)。将该选项留空会完全禁用此功能。更多信息请参见文档 Tool categories - Automatic E2E calculation

Automatic start/stop

‘Test execution’

[‘Test execution’, ‘Configuration start/stop’, ‘Never’]

string

This option affects whether the FlexRay controller will be started and stopped automatically. If ‘Never’ is chosen, the controller must be started and stopped explicitly using the port Job ‘SwitchBusState’.

Caution: all timestamps (e.g. in ASC traces) are relative to the time of the controller start.

Reinitialize on loss of bus synchronization

☑

bool

If this option is set, the FlexRay controller will automatically be reinitialized when it loses synchronization to the bus. Caution: if necessary, the reinitialization is performed even if the option ‘Automatic start/stop’ is set.

仅监听

☐

bool

Controller is running in passive mode. Writing is not possible

Configuration mode

‘Configuration file’

[‘Configuration file’]

string

If there are several methods to configure this port, the one to be used can be chosen here. The mode ‘configuration file’ requires a path in the corresponding setting. The mode ‘bus database’ extracts the required information from the bus database.

Configuration file

string

Only required in the configuration mode ‘configuration file’.

Full path to the configuration file.

Transmission confirmation

☐

bool

启用确认式发送。Bus-Write test step 和 Send 工具作业会阻塞,直到报文成功传输到总线上或确认超时到期。

传输确认的超时时间

1000

int

消息必须在此时间段(毫秒)内成功发送。否则会产生错误。(不得大于 64535ms)。仅在主动确认模式下使用。

Error frames

☐

bool

Error frames will be logged only if ‘True’

Null frames

☐

bool

Null frames will be logged only if ‘True’

ClearFrame

清除指定帧的接收缓冲区

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel

‘A’

[‘A’, ‘B’, ‘*’]

string

FlexRay Channel (A, B or *)

CycleRepetition

int

Cycle repetition

SlotId

int

Frame ID

StartCycle

int

Start cycle

CloseFrTpSession

Closes the FrTP session.

Parameterization

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

return

[False, True]

bool

会话已成功关闭

DeregisterFrameForInbox

Ungeristers a frame that is being streamed to an inbox

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel

‘A’

[‘A’, ‘B’, ‘*’]

string

FlexRay Channel (A, B or *)

CycleRepetition

int

Cycle repetition

Inbox

object

现有收件箱

SlotId

int

Frame ID

StartCycle

int

StartCycle (cycle offset)

DeregisterStreamForInbox

Deregisters a FrTp session.

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

conId

int

Connection ID

DisableSendFrameCyclic

停用对具有指定 ID 的报文的周期发送

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel

‘A’

[‘A’, ‘B’, ‘*’]

string

FlexRay Channel (A, B or *)

CycleRepetition

int

Cycle repetition

SlotId

int

Frame ID

StartCycle

int

Start cycle

GetFirstValue

Reads the first received value of the given signal

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

FrameName

string

Frame name

NodeName

string

电子控制单元的名称

RawValue

False

[False, True]

bool

如果为 ‘True’,则返回原始值。

reset

False

[False, True]

bool

若为 ‘True’,则第一个接收到的值在被读取后将被删除

SignalName

string

信号名称

InitFrame

Initializes the given frame

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel

‘A’

[‘A’, ‘B’, ‘*’]

string

FlexRay Channel (A, B or *)

CycleRepetition

int

Cycle repetition

DataLength

int

Length in words

SlotId

int

Frame ID

StartCycle

int

StartCycle (cycle offset)

OpenFrTpSession

Opens a FlexRay TP session.

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

acknowledged

False

[False, True]

bool

The acknowledge bit (C_CT communication type) signals whether the sender requires a confirmation of receipt (acknowledged, STFA) or not (unacknowledged, STFU). - Integer

blockSize

0

int

Block size in bytes; maximum number of bytes that may be transmitted in the following consecutive frames before the sender has to wait for another flow control frame. - Integer

fillByte

ByteStream

用于填充报文的字节(可选) - 长度为 1 的 ByteStream

flowControlAddr

-1

int

Different address of the control unit (ECU) for FlowControl - Hex (optional Integer)

maxFrameLength

0

int

一帧的最大长度(字节,适用于首帧、连续帧和末帧);如果该值设为 0,则使用 ISO 10681-2 中描述的最大值 - Integer

mnpc

0

int

MNPC specifies how many consecutive frames the receiver can process within one FlexRay cycle. With MNPC set to 0 the sender can utilize the maximum possible band width. - Integer

requestBaseCycle

int

Cycle offset in the application cycle window - Integer < RequestCycleRepetition

requestCycleRepetition

int

Cycle count after which the frame is sent periodically based on BaseCycle - Integer >= 1

requestSlotId

int

Frame-ID for requests sent to the ECU - 1 or 2 byte Hex (integer)

responseBaseCycle

int

Cycle offset in the application cycle window - Integer < ResponseCycleRepetition

responseCycleRepetition

int

Cycle count after which the frame is received periodically based on BaseCycle - Integer >= 1

responseSlotId

int

Frame-ID for ECU responses - 1 or 2 byte Hex (integer)

scExp

0

int

SC defines the minimum distance in cycles until the sender is allowed to send the next consecutive frame. SC = 2^SCexp - 1 - Integer

sourceAddr

int

Address of the tester (ecu.test) - Hex (integer)

targetAddr

int

Address of the ECU - Hex (integer)

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

return

int

Connection ID

ReadFrame

Reads the given frame (use InitFrame before!)

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel

‘A’

[‘A’, ‘B’, ‘*’]

string

FlexRay Channel (A, B or *)

CycleRepetition

int

Cycle repetition

doDelete

False

[False, True]

bool

若为 “True”,则在读取后删除该帧

SlotId

int

Frame ID

StartCycle

int

StartCycle (cycle offset)

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

result

ByteStream

ByteStream

ReadFrameEx

Reads the given frame (use InitFrame before!)

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel

‘A’

[‘A’, ‘B’, ‘*’]

string

FlexRay Channel (A, B or *)

CycleRepetition

int

Cycle repetition

doDelete

False

[False, True]

bool

若为 “True”,则在读取后删除该帧

SlotId

int

Frame ID

StartCycle

int

StartCycle (cycle offset)

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

result

object

FlexRayFrame

RegisterFrameForInbox

注册一个帧,以便将其流式传输到 Inbox。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel

‘A’

[‘A’, ‘B’, ‘*’]

string

FlexRay Channel (A, B or *)

CycleRepetition

int

Cycle repetition

Inbox

object

现有收件箱

saveAsFlxFrame

False

[False, True]

bool

If True, the frame is saved as a FlexRayFrame object, else as a ByteStream

SlotId

int

Frame ID

StartCycle

int

StartCycle (cycle offset)

RegisterStreamForInbox

Registers a FrTp session to be streamed to an inbox.

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

conId

int

Connection ID

inbox

object

现有收件箱

ResetFirstValue

清除给定信号的第一个已接收值

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

FrameName

string

Frame name

NodeName

string

电子控制单元的名称

SignalName

string

信号名称

SendFrame

Sends the given frame ID. Frame ID must be registered in advance via the job “InitFrame”.

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel

‘A’

[‘A’, ‘B’, ‘*’]

string

FlexRay Channel (A, B or *)

CycleRepetition

int

Cycle repetition

Data

ByteStream

要发送的数据

SlotId

int

Frame ID

StartCycle

int

Start cycle

SendFrameCyclic

以给定的 ID 和数据循环发送报文。报文 ID 必须事先通过作业 “InitFrame” 注册。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel

‘A’

[‘A’, ‘B’, ‘*’]

string

FlexRay Channel (A, B or *)

Count

int

发送重复次数

CycleRepetition

int

Cycle repetition

DataByteStream

ByteStream

要发送的数据

Interval

int

Cycle time in ms; 0 for every cycle

SlotId

int

Frame ID

StartCycle

int

Start cycle

SendStream

Send a data stream via FrTp.

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

conId

int

Connection ID

data

object

Payload to be sent via FrTp

timeout

int

发送消息的超时时间,单位毫秒

SetFlowControlCTS

Activates to always send a Flow Control “ContinueToSend” message in response to a segmented request. Also new values can be assigned to the internal parameters BlockSize, MNPC and SCexp.

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

BlockSize

int

Block size in bytes; maximum number of bytes that may be transmitted in the following consecutive frames before the sender has to wait for another flow control frame. - Integer

如果为 None,则保留来自测试配置、OpenDiagSession 作业或上一次 SetFlowControlCTS 调用的最新设置。

MNPC

int

MNPC specifies how many consecutive frames the receiver can process within one FlexRay cycle. With MNPC set to 0 the sender can utilize the maximum possible band width. - Integer

如果为 None,则保留来自测试配置、OpenDiagSession 作业或上一次 SetFlowControlCTS 调用的最新设置。

SCexp

int

SC defines the minimum distance in cycles until the sender is allowed to send the next consecutive frame. SC = 2^SCexp - 1 - Integer

如果为 None,则保留来自测试配置、OpenDiagSession 作业或上一次 SetFlowControlCTS 调用的最新设置。

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

SetFlowControlWait

激活后,对分段请求始终发送流控 “Wait” 消息。注意:激活期间无法接收任何分段消息。使用 Job SetFlowControlCTS 重置此行为。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

WaitTimeInterval

0

int

等待时间间隔,单位为 ms。如果设为 0,则只发送一次流控制“Wait”消息以响应分段请求。如果设为大于 0 的值,则按给定间隔周期性发送流控制“Wait”消息。

SwitchBusState

Switches the FlexRay controller on or off.

Caution: switching the controller on will reset the ASC timestamps. Recording during the stop and start of the controller may result in an ASC file which violates the monotony of timestamps.

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

State

‘Off’

[‘Off’, ‘On’]

string

New state of the bus